<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Concatenates to a row</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="tokyotyranttable.put.html">TokyoTyrantTable::put</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="tokyotyranttable.putkeep.html">TokyoTyrantTable::putKeep</a></div>
 <div class="up"><a href="class.tokyotyranttable.html">TokyoTyrantTable</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="tokyotyranttable.putcat" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">TokyoTyrantTable::putCat</h1>
  <p class="verinfo">(PECL tokyo_tyrant &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">TokyoTyrantTable::putCat</span> &mdash; <span class="dc-title">Concatenates to a row</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-tokyotyranttable.putcat-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="type"><span class="type void">void</span></span> <span class="methodname"><strong>TokyoTyrantTable::putCat</strong></span>
    ( <span class="methodparam"><span class="type">string</span> <code class="parameter">$key</code></span>
   , <span class="methodparam"><span class="type">array</span> <code class="parameter">$columns</code></span>
   )</div>

  <p class="para rdfs-comment">
   This method can be used to add new columns to existing records. Existing keys will be left unmodified
   but any new columns will be appended to the row. Passing null as key will generate a new row.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-tokyotyranttable.putcat-parameters">
  <h3 class="title">参数</h3>
  <p class="para">
   <dl>

    
     <dt>
<em><code class="parameter">key</code></em></dt>

     <dd>

      <p class="para">
       The primary key of the row or <strong><code>NULL</code></strong>
      </p>
     </dd>

    
    
     <dt>
<em><code class="parameter">columns</code></em></dt>

     <dd>

      <p class="para">
       Array of row contents
      </p>
     </dd>

    
   </dl>

  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-tokyotyranttable.putcat-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   Returns the primary key and throws TokyoTyrantException on error.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-tokyotyranttable.putcat-examples">
  <h3 class="title">范例</h3>
  <p class="para">
   <div class="example" id="example-2162">
    <p><strong>Example #1 <span class="methodname"><strong>TokyoTyrantTable::putCat()</strong></span> example</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">/*&nbsp;Connect&nbsp;to&nbsp;a&nbsp;table&nbsp;database&nbsp;*/<br /></span><span style="color: #0000BB">$tt&nbsp;</span><span style="color: #007700">=&nbsp;new&nbsp;</span><span style="color: #0000BB">TokyoTyrantTable</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">1979</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/*&nbsp;Passing&nbsp;null&nbsp;to&nbsp;put&nbsp;generates&nbsp;a&nbsp;new&nbsp;uid&nbsp;*/<br /></span><span style="color: #0000BB">$index&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">$tt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">put</span><span style="color: #007700">(</span><span style="color: #0000BB">null</span><span style="color: #007700">,&nbsp;array(</span><span style="color: #DD0000">"column1"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"some&nbsp;data"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"column2"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"more&nbsp;data"</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/*&nbsp;Get&nbsp;the&nbsp;row&nbsp;back&nbsp;*/<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$tt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/*&nbsp;Modify&nbsp;an&nbsp;existing&nbsp;row&nbsp;*/<br /></span><span style="color: #0000BB">$tt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">putcat</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">,&nbsp;array(</span><span style="color: #DD0000">"column1"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"something&nbsp;new"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"new_column"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"other&nbsp;data"</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/*&nbsp;Get&nbsp;the&nbsp;row&nbsp;back&nbsp;*/<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$tt</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>以上例程会输出：</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
array(2) {
  [&quot;column1&quot;]=&gt;
  string(9) &quot;some data&quot;
  [&quot;column2&quot;]=&gt;
  string(9) &quot;more data&quot;
}
array(3) {
  [&quot;column1&quot;]=&gt;
  string(9) &quot;some data&quot;
  [&quot;column2&quot;]=&gt;
  string(9) &quot;more data&quot;
  [&quot;new_column&quot;]=&gt;
  string(10) &quot;other data&quot;
}
</pre></div>
    </div>
   </div>
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-tokyotyranttable.putcat-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="methodname"><a href="tokyotyranttable.put.html" class="methodname" rel="rdfs-seeAlso">TokyoTyrantTable::put()</a> - Store a row</span></li>
   </ul>
  </p>
 </div>


</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="tokyotyranttable.put.html">TokyoTyrantTable::put</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="tokyotyranttable.putkeep.html">TokyoTyrantTable::putKeep</a></div>
 <div class="up"><a href="class.tokyotyranttable.html">TokyoTyrantTable</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
